Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Add a note that label id is only required when updating label #2268

Merged
merged 1 commit into from
Feb 17, 2025

Conversation

jhutar
Copy link
Contributor

@jhutar jhutar commented Feb 17, 2025

Fixes Issue

Looking into https://horreum.hyperfoil.io/openapi/#tag/Schema/operation/addOrUpdateLabel API doc says id ("Unique ID for Label") is required. This should be only required when you are updating label, not adding new one. It confused me.

Changes proposed

Just a tiny docs change.

@lampajr lampajr self-requested a review February 17, 2025 08:30
Copy link
Member

@lampajr lampajr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @jhutar, thanks a lot for the PR and it looks great to me!

Unfortunately the OpenAPI spec is auto-generated during the build, therefore rather than doing the change there you should do it here

@Operation(description = "Save new or update existing Label for a Schema")
in the SchemaService definition. Then, if you run mvn clean install -DskipTest -DskipITs you will see the same changes reported on the OpenAPI specs

@jhutar jhutar force-pushed the fix1-label-id-not-required branch from 4d6e603 to 4a026c9 Compare February 17, 2025 09:29
@jhutar
Copy link
Contributor Author

jhutar commented Feb 17, 2025

Thank you Andrea! Fixed that and used the Maven command you mentioned to regenerate that API docs. Hope it is OK now.

Copy link
Member

@lampajr lampajr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you Andrea! Fixed that and used the Maven command you mentioned to regenerate that API docs. Hope it is OK now.

Thanks a lot to you, lgtm!

@lampajr lampajr merged commit fc6b610 into Hyperfoil:master Feb 17, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants